table of contents
PAPI_thread_id(3) | PAPI | PAPI_thread_id(3) |
NAME¶
PAPI_thread_id - get the thread identifier of the current thread
SYNOPSIS¶
C Interface
#include <papi.h> unsigned long PAPI_thread_id(void);
Fortran Interface
#include fpapi.h PAPIF_thread_id(C_INT id)
DESCRIPTION¶
This function returns a valid thread identifier. It calls the function registered with PAPI through a call to PAPI_thread_init().
ARGUMENTS¶
None.
RETURN VALUES¶
On success, this function returns PAPI_OK.
On error, a negative error value is returned.
ERRORS¶
- PAPI_EMISC
- is returned if there are no threads registered.
- -1
- is returned if the thread id function returns an error.
EXAMPLE¶
unsigned long tid; if ((tid = PAPI_thread_id()) == (unsigned long int)-1)
exit(1); printf("Initial thread id is: %lu\n",tid);
BUGS¶
This function has no known bugs.
SEE ALSO¶
September, 2004 | PAPI Programmer's Reference |